# ممیزی جامع، مستقل و دقیق پروژه ForiCode — بدون تغییر کد و دیتابیس

پروژه من در مسیر زیر قرار دارد:

`C:\laragon\www\foricode-now`

این پروژه یک فروشگاه Laravel است که بخش‌هایی از آن قبلاً توسعه، اصلاح و تست شده‌اند. اکنون می‌خواهم قبل از ادامه توسعه و فروش واقعی، یک ممیزی فنی، امنیتی، مالی و معماری دقیق انجام دهی.

**این درخواست صرفاً Audit است، نه درخواست رفع مشکل.**

هدف من این نیست که یک گزارش کلی از نقاط قوت و ضعف ارائه کنی. می‌خواهم وضعیت واقعی پروژه را از روی سورس فعلی، تاریخچه Git، مستندات، تنظیمات، ساختار دیتابیس و تست‌های موجود با شواهد قابل بازبینی مشخص کنی.

## قوانین قطعی

1. هیچ فایل پروژه را ویرایش، حذف یا بازنویسی نکن.
2. هیچ Migration، Seeder یا Fix Script اجرا نکن.
3. هیچ داده واقعی دیتابیس را تغییر نده.
4. هیچ خرید واقعی، تراکنش مالی، پیامک، ایمیل یا فراخوانی واقعی FiveSim انجام نده.
5. هیچ رمز، توکن، کلید API یا داده حساس را در گزارش افشا نکن.
6. برای تست‌های مخرب یا هم‌زمانی، فقط از دیتابیس آزمایشی ایزوله و داده ساختگی استفاده کن؛ آن هم بدون تأثیر بر محیط فعلی.
7. اگر آزمایش ایزوله امن امکان‌پذیر نیست، آن را اجرا نکن و صریحاً گزارش بده.
8. از کل پروژه واقعی استفاده کن. به جست‌وجوی محدود Workspace یا چند فایل اکتفا نکن.
9. هیچ نتیجه‌ای را صرفاً با حدس، اسم فایل یا مستندات قدیمی قطعی اعلام نکن.
10. هیچ Feature جدیدی پیاده‌سازی نکن.

---

# بخش اول — مشخص کردن وضعیت واقعی پروژه

قبل از تحلیل:

- مسیر واقعی پروژه را تأیید کن.
- Git HEAD و وضعیت Working Tree را بخوان.
- آخرین Commitها و Tagهای مرتبط را شناسایی کن.
- مشخص کن کدام اصلاحات در نسخه فعلی وجود دارند.
- فایل‌های Documentation و TODO را با سورس فعلی تطبیق بده.
- مواردی را که قبلاً اصلاح شده‌اند دوباره به‌عنوان باگ باز گزارش نکن.

برای هر مسئله یکی از این وضعیت‌ها را مشخص کن:

- **Confirmed:** مشکل با کد و شواهد مشخص تأیید شده.
- **Fixed:** مشکل قبلاً رفع شده و اصلاح آن در نسخه فعلی اثبات شده.
- **Potential:** احتمال وجود مشکل هست ولی هنوز اثبات نشده.
- **Needs Runtime Verification:** کد بررسی شده ولی برای نتیجه قطعی تست عملی لازم است.
- **Intentional / Deferred:** رفتار عمداً برای فاز بعد باقی مانده.
- **Not Applicable:** مسئله مربوط به این نسخه یا این معماری نیست.

---

# بخش دوم — اولویت ویژه: Migration و Deploy

این مورد برای من بسیار مهم است.

ما قبلاً درباره Migration و Deploy چندین مرحله کار کرده‌ایم و برنامه‌نویس قبلی گزارش داده بود برخی مشکلات برطرف شده‌اند.

نمی‌خواهم صرفاً چون یک فایل Documentation قدیمی نوشته Migration مشکل دارد، دوباره همان مشکل را قطعی اعلام کنی.

### مواردی که باید دقیق بررسی شوند

1. جدول `migrations` در دیتابیس فعلی چه وضعیتی دارد؟
2. آیا Migrationهای موجود با Schema واقعی دیتابیس منطبق هستند؟
3. آیا Migration ثبت‌نشده‌ای وجود دارد که جدول یا ستون آن از قبل ساخته شده باشد؟
4. آیا اجرای معمول `php artisan migrate` همچنان احتمال خطا یا اجرای تغییر ناخواسته دارد؟
5. آیا برای Migrationهای جدید راهکار Targeted Migration تهیه شده؟
6. آیا Installer یا Upgrade Script موجود روش جداگانه‌ای برای تغییر دیتابیس دارد؟
7. آیا اسناد `VN_PHASE_DEPLOY_TODO.md` و سایر TODOها هنوز معتبر هستند یا قدیمی شده‌اند؟
8. آیا تغییرات اخیر Settings اساساً Migration لازم داشتند؟
9. آیا روش Deploy پروژه با معماری فعلی آن سازگار است؟
10. آیا دیتابیس تازه و دیتابیس موجود هر دو مسیر نصب/ارتقای مشخص و قابل تکرار دارند؟

**هیچ Migration واقعی اجرا نکن.** اگر برای اثبات نهایی به اجرای Migration نیاز است، فقط در محیط کاملاً ایزوله و قابل حذف آزمایش کن.

### روش واقعی استقرار من

من برای انتقال تغییرات از لوکال به هاست، روش فعلی مبتنی بر فایل PHP نصب/اصلاح را دارم.

بدون دلیل اثبات‌شده، روش Deploy را به Git Checkout مستقیم روی هاست یا روش دیگری تغییر نده.

این موارد را بررسی کن:

- Installer موجود چگونه تغییرات فایل و دیتابیس را اعمال می‌کند؟
- آیا از اطلاعات حساس به‌درستی محافظت می‌کند؟
- آیا در اجرای مجدد امن است؟
- آیا امکان Rollback وجود دارد؟
- آیا تغییرات DB و فایل‌ها هماهنگ اجرا می‌شوند؟
- آیا پیش‌نیازها و وضعیت نصب قبلی بررسی می‌شوند؟

**نتیجه صریح می‌خواهم:**

آیا Migration/Deploy در نسخه فعلی واقعاً حل شده، نیمه‌حل شده یا هنوز مشکل دارد؟

اگر قبلاً حل شده، با کد و شواهد ثابت کن؛ آن را دوباره در لیست باگ‌ها قرار نده.

---

# بخش سوم — امنیت فایل‌ها و Git

یافته‌های گزارش قبلی خودت را دوباره بررسی کن:

- `.env` تحت کنترل Git
- فایل‌های ZIP
- آرشیو دیتابیس
- `.gitignore`
- فایل‌های حساس در Git History
- مسیر Document Root
- تنظیمات `.htaccess`
- امکان دسترسی اینترنتی به فایل‌های غیرعمومی

برای هر مورد دقیقاً بگو:

1. واقعاً وجود دارد؟
2. فقط ریسک تئوری است یا آسیب‌پذیری تأییدشده؟
3. چه شرایطی آن را قابل سوءاستفاده می‌کند؟
4. آیا فایل حساس در تاریخچه Git باقی مانده؟
5. آیا مخزن عمومی است یا این موضوع قابل تعیین نیست؟
6. برای رفع ایمن چه کاری لازم است؟

به فایل‌های حساس دسترسی بگیر فقط در حد ضرورت بررسی؛ محتوا و Secretهای آنها را در خروجی چاپ نکن.

---

# بخش چهارم — امنیت نصب و Cron

فایل‌های زیر و تمام مسیرهای مرتبط را بررسی کن:

- `install.php`
- `cron-schedule.php`
- `installed.lock`
- Installerهای دیگر
- اسکریپت‌های Maintenance
- مسیرهای اجرای Task Scheduler

بررسی کن:

- آیا پارامتر `force` واقعاً بدون احراز هویت قفل نصب را حذف می‌کند؟
- آیا امکان اجرای مجدد Installer از طریق وب وجود دارد؟
- آیا درخواست وب می‌تواند Cron را اجرا کند؟
- آیا سازوکار فعلی با Apache، LiteSpeed، PHP-FPM و CLI سازگار و ایمن است؟
- آیا فایل‌های نصب بعد از استقرار در معرض دسترسی عمومی باقی می‌مانند؟

هیچ تلاش مخرب یا اجرای Installer انجام نده.

---

# بخش پنجم — صحت عملیات مالی

این بخش Critical است.

تمام سرویس‌ها و مسیرهای مربوط به:

- Wallet
- Wallet Transactions
- Payment
- Gateway Callbacks
- Refund
- Withdraw
- Orders
- Bonus Credit
- Card-to-card
- Tax

را بررسی کن.

## Wallet

مشخص کن آیا در تمام عملیات برداشت، مصرف اعتبار، بازپرداخت و رد درخواست برداشت:

- موجودی داخل تراکنش بررسی می‌شود؟
- `lockForUpdate` یا محافظ معادل وجود دارد؟
- موجودی منفی غیرمجاز است؟
- تراکنش تکراری قابل جلوگیری است؟
- دوبار Refund ممکن است؟
- درخواست هم‌زمان می‌تواند موجودی را دوبار مصرف کند؟

## Payment Callback

بررسی کن:

- پرداخت چه زمانی `PAID` می‌شود؟
- سفارش چه زمانی تکمیل می‌شود؟
- شارژ/کسر کیف پول چگونه انجام می‌شود؟
- اگر بعد از تأیید پرداخت خطا رخ دهد، چه می‌شود؟
- Callback تکراری چگونه کنترل می‌شود؟
- دو Callback هم‌زمان چه رفتاری دارند؟
- آیا مبلغ، ارز، شماره سفارش و هویت درگاه اعتبارسنجی می‌شود؟
- آیا امکان Replay یا انتخاب Payment متعلق به درگاه دیگر وجود دارد؟
- آیا سیستم برای وضعیت مبهم و خطای میانی، Reconciliation دارد؟

فقط گفتن «DB::transaction وجود دارد» کافی نیست.

مرز تراکنش و ترتیب واقعی عملیات را Trace کن.

برای هر آسیب‌پذیری مالی، سناریوی دقیق ایجاد مغایرت را توضیح بده.

---

# بخش ششم — رزرو موجودی دیجیتال

بررسی کن فروش هم‌زمان:

- اکانت
- کد دیجیتال
- گیفت کارت
- اشتراک
- Inventoryهای مشابه

می‌تواند یک موجودی را به دو سفارش اختصاص دهد یا نه.

روش‌های رزرو، Lock، Atomic Update و تحویل را بررسی کن.

اگر مشکل تأیید شد، مشخص کن دقیقاً کدام نوع موجودی تحت تأثیر است.

---

# بخش هفتم — شماره مجازی

این بخش را با توجه به تصمیم‌های قبلی پروژه تحلیل کن.

**خرید شماره مجازی عمداً در Phase 1 حالت Mock دارد.**

بنابراین Mock بودن را به‌عنوان باگ غیرمنتظره گزارش نکن.

اما مشخص کن:

- کدام قابلیت‌ها واقعاً عملیاتی هستند؟
- کدام‌ها فقط Mock هستند؟
- کدام‌ها برای Phase 2 باقی مانده‌اند؟
- آیا هیچ مسیر Mock به‌اشتباه در Production قابل خرید واقعی نشان داده می‌شود؟
- آیا مسیرهای Cancel/Ban/Refund ایمن هستند؟
- آیا State Machine و Wallet Flow برای اتصال واقعی آماده‌اند؟
- آیا APIهای واقعی FiveSim در Page Load فراخوانی می‌شوند؟
- آیا مرز Mock و Real Provider روشن است؟
- آیا سفارش، شماره، OTP و اطلاعات مشتری به‌درستی محافظت می‌شوند؟

Auto-expire، Cancel Cooldown، Quick Access و اتصال FiveSim واقعی هنوز Featureهای برنامه‌ریزی‌شده‌اند؛ آنها را به‌جای ضعف پنهان با عنوان **Deferred** طبقه‌بندی کن.

---

# بخش هشتم — Authentication و Authorization

بررسی کن:

- Login/Register
- Email Verification
- Password Reset
- Sessions
- CSRF
- Rate Limiting
- Admin Permissions
- User Ownership
- IDOR
- Uploads
- Private Files
- API Access
- Sensitive Data Exposure

به‌خصوص بررسی کن آیا کاربر می‌تواند با تغییر ID به اطلاعات سفارش، کیف پول، شماره یا داده شخص دیگری دسترسی پیدا کند.

---

# بخش نهم — Settings

معماری Settings قبلاً چندین پاس Audit شده و اصلاح شده است.

نسخه جدید شامل:

- هویت `(group,key)`
- Canonical read/write
- `getExact`
- `groupMap`
- تست‌های دائمی
- پاکسازی Duplicateهای قبلی

است.

بدون یافتن باگ واقعی، دوباره این معماری را Refactor نکن.

اما موارد زیر را بررسی کن:

- آیا Contract جدید همچنان درست است؟
- آیا Secretها محافظت می‌شوند؟
- آیا Cache صحیح invalidate می‌شود؟
- آیا دسترسی‌ها درست هستند؟
- آیا مقدارهای `0`، `false`، `null` و empty درست تفسیر می‌شوند؟
- آیا الگوهای `?: default` در Consumerها باعث تغییر رفتار می‌شوند؟

این الگوهای قدیمی قبلاً گزارش شده‌اند:

- `card_auto_confirm_tolerance`
- `card_auto_confirm_window`
- `abandoned_cart_max_reminders`
- `order_auto_cancel_minutes`

وجود مشکل را از روی مصرف‌کننده و معنای معتبر مقدار صفر بررسی کن، نه صرفاً دیدن عملگر `?:`.

---

# بخش دهم — تست‌ها و قابلیت بازسازی پروژه

بررسی کن:

- PHPUnit tests
- Feature tests
- Unit tests
- Mock providers
- Payment tests
- Wallet tests
- Concurrency tests
- Database tests
- Migration tests
- Composer dependencies
- Frontend build tools
- `package.json`
- Vite یا ابزار جایگزین
- دستورهای نصب و Build

مشخص کن آیا پروژه از همین پوشه و مستندات موجود قابل بازسازی است.

برای هر تست مهمِ غایب، توضیح بده چه خطر واقعی‌ای را پوشش نمی‌دهد.

---

# بخش یازدهم — Performance و نگهداری

بررسی کن:

- N+1
- Queryهای سنگین
- Pagination
- Offer Loading
- Cache
- فایل‌های بسیار بزرگ
- تکرار Routeها
- Scheduler
- Queue
- Log Growth
- Indexهای دیتابیس
- Memory Usage

مخصوصاً:

- `/numbers`
- `/products`
- Admin Products
- Virtual Number Admin
- My Numbers
- `/sitemap.xml`

تا زمانی که اندازه‌گیری واقعی نداریم، صرف طولانی‌بودن فایل یا زیادبودن Query را به‌عنوان باگ بحرانی طبقه‌بندی نکن.

---

# بخش دوازدهم — مرورگر واقعی

برای هر مورد User-facing یا Admin-facing که نیازمند تأیید UI است، در صورت دسترسی از Chrome واقعی یا Headless Chrome با Session معتبر استفاده کن.

صرف HTTP 200، بررسی قالب Blade یا DOM خام کافی نیست.

در صورت امکان بررسی کن:

- Rendered UI
- Console
- Network
- Navigation
- Forms
- Validation
- Permission Errors

اما چون این پاس Read-Only است، هیچ Save یا عملیات دارای اثر جانبی روی داده‌های واقعی انجام نده.

اگر برای اثبات نهایی به Interaction تغییر‌دهنده داده نیاز است، آن تست را جداگانه در وضعیت `Needs Runtime Verification` قرار بده.

---

# قالب اجباری گزارش نهایی

## A — Executive Summary

- پروژه در چه وضعیتی است؟
- آیا برای Production آماده است؟
- آیا برای فروش واقعی آماده است؟
- پنج خطر مهم و اثبات‌شده کدام‌اند؟

## B — Migration / Deploy Verdict

این بخش جدا و در ابتدای گزارش باشد.

به‌طور قطعی و مستند بگو مسئله قدیمی Migration واقعاً حل شده یا نه.

اگر تأیید عملی ممکن نیست، با عنوان `Needs Runtime Verification` مشخص کن.

## C — Findings Table

برای هر یافته جدول زیر را تکمیل کن:

| ID | Severity | Status | File:Line | Evidence | Impact | Recommended Fix | Verification |
|---|---|---|---|---|---|---|---|

Severity:

- Critical
- High
- Medium
- Low
- Informational

هر یافته باید شماره ثابت داشته باشد، مثلاً `SEC-01`، `FIN-01`، `DEP-01`.

## D — تفکیک مشکلات

چهار دسته مشخص:

1. مشکلات اثبات‌شده و رفع‌نشده
2. مشکلات احتمالی که تست بیشتر لازم دارند
3. مشکلاتی که قبلاً رفع شده‌اند
4. قابلیت‌هایی که عمداً برای Phase بعد باقی مانده‌اند

این دسته‌ها را با هم قاطی نکن.

## E — نقشه راه اصلاح

بر اساس ریسک و وابستگی‌ها مشخص کن:

- P0: قبل از هر Deploy یا فروش واقعی
- P1: قبل از فعال‌سازی گردش پول و سفارش
- P2: قبل از راه‌اندازی عمومی
- P3: بهبودهای بلندمدت

برای هر مرحله:

- چه چیزی باید اصلاح شود؟
- چرا؟
- چه فایل‌ها/ماژول‌هایی درگیرند؟
- چه تستی Pass شدن اصلاح را اثبات می‌کند؟
- چه وابستگی‌هایی به مراحل دیگر دارد؟

## F — مواردی که باید من تصمیم بگیرم

فقط تصمیم‌های واقعی Business/Architecture را مطرح کن.

مشکلات فنی‌ای که خودت می‌توانی اثبات کنی را بی‌دلیل به من واگذار نکن.

## G — گزارش سلامت ممیزی

در پایان صریح اعلام کن:

- Git HEAD اولیه و نهایی
- Git dirty قبل و بعد
- تعداد فایل‌های تغییرکرده
- تعداد عملیات Write روی DB واقعی
- تست‌های اجراشده و نتایج
- مواردی که نتوانستی اثبات کنی
- محدودیت‌های ابزار

---

# مهم‌ترین دستور

هدف این ممیزی پیدا کردن حقیقت است، نه تأیید گزارش قبلی و نه دفاع از کد فعلی.

اگر تحلیل قبلی خودت اشتباه بوده، صریح اصلاحش کن.

اگر مشکلی قبلاً حل شده، دوباره آن را در فهرست ضعف‌های باز قرار نده.

اگر مشکلی واقعاً خطرناک است، مدرک دقیق بده.

اگر فقط احتمال است، آن را قطعی اعلام نکن.

هیچ Fix، Refactor، Migration یا Deploy انجام نده.

**فقط بررسی جامع، طبقه‌بندی دقیق، شواهد و نقشه راه اصلاح ارائه کن و متوقف شو.**